screen_reader_unload_library
This function will unload the DLL for the specified screen reader.
bool screen_reader_unload_library(int reader)
Parameters:
reader
A value representing one of the two screen readers for which this operation is supported (see remarks).
Return value:
true on success, false on failure.
Remarks:
While Windows is using a dll, it cannot be deleted or removed. Therefore this function is useful if you want to delete the DLL file, for instance if you have packaged it into an executable and extract it to a temporary location during the execution of your script. After unloading the dll for the given screen reader, it may then be manipulated like any other file.
This function will work with two of the four supported screen readers, namely System Access and NVDA. If you attempt to use this function with Jaws or WindowEyes, the function will fail as these readers use COM rather than standard DLL calls.
Note that if you call any screen reader functions later except screen_reader_set_library_path, it will automatically attempt to reload the dll for that screen reader if applicable.
Example:
// Set the path of the NVDA screen reader and get it to speak some text, then delete the DLL afterwards.
void main()
{
screen_reader_set_library_path(NVDA, DIRECTORY_TEMP+"/NVDA.dll");
screen_reader_speak(NVDA, "Hi. My library is now in the temp directory!");
wait(2000);
screen_reader_unload_library(NVDA);
file_delete(DIRECTORY_TEMP+"/NVDA.dll");
}